'\" t
.\"     Title: bugle-trace
.\"    Author: 
.\" Generator: DocBook XSL Stylesheets v1.78.1 <http://docbook.sf.net/>
.\"      Date: October 2007
.\"    Manual: Bugle user manual
.\"    Source: BUGLE 0.0.20150628
.\"  Language: English
.\"
.TH "BUGLE\-TRACE" "7" "October 2007" "BUGLE 0.0.20150628" "Bugle user manual"
.\" -----------------------------------------------------------------
.\" * Define some portability stuff
.\" -----------------------------------------------------------------
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.\" http://bugs.debian.org/507673
.\" http://lists.gnu.org/archive/html/groff/2009-02/msg00013.html
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.ie \n(.g .ds Aq \(aq
.el       .ds Aq '
.\" -----------------------------------------------------------------
.\" * set default formatting
.\" -----------------------------------------------------------------
.\" disable hyphenation
.nh
.\" disable justification (adjust text to left margin only)
.ad l
.\" -----------------------------------------------------------------
.\" * MAIN CONTENT STARTS HERE *
.\" -----------------------------------------------------------------
.SH "NAME"
bugle-trace \- record a log of OpenGL calls made
.SH "SYNOPSIS"
.sp
.nf
filterset trace
filterset log
{
    filename "\fItrace\&.txt\fR"
}
.fi
.SH "DESCRIPTION"
.PP
This filter\-set provides a log of the OpenGL calls made\&. For each call, the function name, the parameters and the return value (if any) are recorded\&. Where appropriate, symbolic names are shown for
\fBGLenum\fR
parameters, and pointers are followed to show the correct number of elements\&.
.SH "OPTIONS"
.PP
There are no options to control this filter\-set\&. All logging is done through bugle\*(Aqs logging system (see
\fBbugle-log\fR(7)), and options such as filename and log format can be modified there\&.
.SH "OUTPUT"
.PP
Here is a sample log output
.sp
.if n \{\
.RS 4
.\}
.nf
[INFO] trace\&.call: glClear(GL_COLOR_BUFFER_BIT | GL_DEPTH_BUFFER_BIT)
[INFO] trace\&.call: glLoadMatrixd(0xbfffe610 \-> { { 0, \-0\&.29661, 1\&.22295, 0 }, { 1\&.22295, 0, 0, 0 }, { 0, 1\&.18644, 0\&.305739, 0 }, { 0\&.037888, 1\&.61781, \-1\&.52576, 1 } })
[INFO] trace\&.call: glActiveTextureARB(GL_TEXTURE0)
[INFO] trace\&.call: glTexEnvfv(GL_TEXTURE_ENV, GL_TEXTURE_ENV_COLOR, 0xbfffe5d0 \-> { 0\&.778524, 0\&.778524, 0\&.569631, 0 })
.fi
.if n \{\
.RE
.\}
.SH "BUGS"
.PP
Some enumerants share values, so you may see a different symbolic name in the log than in your source code\&. It is believed that this should be limited to cases where extensions share a value for semanticly equivalent symbols; if you find a case where this is not true, please inform the author\&.
.PP
Because the filter\-set examines arguments and follows pointers, it is possible to crash it by passing invalid values, particularly invalid pointers\&.
.SH "BACKWARDS COMPATIBILITY"
.PP
In previous versions, the
trace
filter\-set also reported OpenGL errors to the log\&. This is now handled by the
showerror
filter\-set (see
\fBbugle-showerror\fR(7))\&.
.SH "AUTHOR"
.PP
bugle
is written and maintained by
Bruce Merry\&.
.SH "SEE ALSO"
.PP
\fBbugle\fR(3),
\fBbugle-log\fR(7),
\fBbugle-showerror\fR(7)
